MilMOTD 



"DEDICATED TO EXCELLENCE IN OS-9 COMPUTING" 



Officers: 

President: 
Vice President: 
Secretary / Tres: 
Librarian: 
MOTD Editor: 



Boisy Pitre 
Carl Kreider 
Debi Kreider 
Zack Sessions 
Alan Sheltra 



Winter Issue 1992 The Official Voice of the OS-9 Ufcers Group 



Volume 1, Number 3 




from the 
OS-9 Users Group 

Editorial by Alan Sheltra 

33t's the holiday season already! 
Where did the time go? Well, we've 
got some goodies for you this mcnth. 

Hope you haven't stuffed your "guts" 
with too much turkey this past 
Thanksgiving, 'cause we have some 
desert for your OS-9 box. 

A hands-on review of the new 
UltraScience port of OS-9 for the 
Macintosh. This is good news for Mac 
owners, who can now have their favorite 
operating system on their Macs. 

We continue our articles from last 
month on Awk and Bawk. 

The OS-9 Users Group has a new 
Librarian. Scott McGee had to step 
down due to personal reasons. Welcome 
Zack Sessions to fill that role now. 
Welcome aboard Zack! 

I should also mention that the OS-9 
Users Group now has a new (and Final!) 
mailing address: 

P.O. Box 71131, Dee Moine, IA 50325 

Until next time I hope you have a Happy and 
Safe Holiday Season! 

Alan Sheltra - MOTD Editor 
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by Mark Heilpern 

Recently, I had the pleasure of 
examining a port of OS-9, for the 
Macintosh computer. This port is 
released by UltraScience/Gibbs 
Laboratories. My review is based on 
my experiences with OS-9 on a Mac 
Powerbook 140, System 7.0.1, and 
OS-9V2.4. 

The port seems to be put together 
rather well. The basic scheme of 
things is that to start up OS-9, you 
merely launch an application, which 
does some preliminary setup to place 
OS-9 in control of the CPU, and still 
allows the Finder (or, Multi-Finder) 
to run in the background. Also, any 
(Continued Page Three) 
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An Editorial 



by User Group Vice President 
Carl Kreider 

Many of you will recall that I was 
the assistant librarian and then 
librarian for the now defucnct OS-9 
User Group. I was Founding Member 
#39. I noted the passing of the group 
with more than a bit of sadness. I had 
put a lot of time and energy into the 
group. But the pain wasn't from only 
selfish reasons, I felt like the UG 



provided a useful service. The library 
was the best repository of public domain 
software for OS-9. Later the online 
services accumulated quite a bit 
(including that of the UG), but in the 
beginning, the UG was all there was. 
We had a newsletter (admittedly 
sparodic) that helped keep us up on 
events. Later the 68 Micro Journal 
began to cover a bit of OS-9, as did 
Rainbow, but in the beginning, the UG 
was all there was. 

And now we seem to have come full 
circle. Rainbow is all but gone. Don 
Williams (and apparently 68 Micro 
Journal) is gone. Tandy has orphaned 
the CoCo. CompuServe, for one, has cut 
back support for OS-9 in favor of DOS. 
So it seemed like there was a need for 
an OS-9 User Group again. 

Sure, the guys with the OS9CN were 
trying to fill the void, but there are a lot 
of folks out there who aren't on FIDO. 
So when Boisy asked me to help, I 
agreed to become Vice President. It has 
been a bit difficult to get going, but we 
are moving forward. We now have 
about 116 members (including overseas 
members), and continue to grow. The 
MOTD looks better than it ever has. 
The library is beginning to shape up 
nicely. 

Contributions are starting to roll in. 
We plan to continue to provide a way for 
the remaining OS-9 lovers to stay in 
contact with each other and with 
vendors. We plan to continue to provide 
a way for the faithful to share their 
software creations. And if CDI should 
take off, or OS-9000 become a cost 
effective option for 486 mavens, we 
could see a great swelling of the ranks. 
All in all, I see a great future for the OS- 
9 in general and the OS-9 User Group in 
particular. 

Carl Kreider 

Usenet: uunet!rde!gator!syscon!carl 
CIS: 71076,76 

Internet : carl@syscon.rn.com 
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(Continued from Page One) 

application that is Multi-Finder tolerant 

can run as well. 

Rather than require an external disk 
or physical disk partitioning, 
UltraScience took an interesting 
approach where you use pseudo-disks as 
hard devices, which are seen as files on 
the Mac's disk. You may have up to 
eight separate logical disks for OS-9, 
each of which can be any size. One of 
them must be used as a bootable disk, 
containing a valid OS9Boot file on it. 

As for device drivers, there exists 
support for using the Mac's devices with 
what appears to be some type of "pass- 
through" driver. I had no problems 
using the serial ports on my Mac. Also, 
included with the package is a driver to 
allow use of a Teac floppy drive for OS- 
9. (However, there is no support for 
using the Mac's SuperDrive in 
Universal format.) Also, OS-9 has a 
special device, /mO, which allows access 
to any files on a Mac format disk. 
(However, since file name conventions 
differ between the two os ! s, there is 
often problems getting to files this way.) 

As advertised, this version of OS-9 
should provide a MacToolBox library 
which allows programming of 
applications that use the Mac's built-in 
hardware (Quick Draw, etc.), however, 
the version I tested did not have this 
feature. After calling the company, I 
learned that they had this working, 
however, "any technical Mac user could 
unravel what we have done, removing 
the mystery", i.e., they don't want 
anyone reverse engineering their 
product. They also told me that they 
were planning a release that would be 
more secure and just as functional. I am 
curious as to how their modifications 
will affect the speed of ToolBox calls. 

One abnormality I found, whenever 
you fork (from the shell) a new process, 
with redirection of all paths to /term, 
the process appears in a new window. 



This can be helpful, but they are both 
device /term! I'm sure this can cause 
great confusion under normal 
circumstances. 

I discovered an annoyance with their 
terminal emulation, which rims under 
the TERM type of "Mac", they have no 
support for inverse characters! 

Overall, I did enjoy using OS-9 on 
the Macintosh, and I foresee 
UltraScience improving their software 
in the not-too-distant future. 

Mark Heilpern 



OS-7 User 

Group 
TeeShirts 

It appears that demand for 
our Tick butt In Real-Tine" t- 
shirts have surged. To appeal 
the masses, we have ordered 
another run of the popular in- 
your-face shirts. Onlij 30 have 
been ordered, and sone have 
been spoken for alreadq. AH 
shirts are nade of 50% cotton, 
50% polyester and feature the 
OS-° Users Group Loa,o on the 
back. 



Size 


Member 


Non-Menber 




Pnce 


Price 


L, XL 


$13.00 


$15.00 


XXL 


$1150 


$16.50 



Send qour Check or M.O. to The OS -9 
Users Group, Please state quantity 

and size. Send to: 
P.O. box 71131, Des Moine, IA 50325 
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The GNU AWK is "fully" compliant with the 
formal definition of AWK as described in "The AWK 
Programming Language" by Aho, Kernighan and 
Weinberger. (See my comments on this in the 
previous article published last time. Z.) 

We talked about gawk's command line syntax 
and options, what an awk program is and what it's 
basic structure is. We learned that each awk program 
statement has two parts, a pattern and an action. We 
also discussed a couple of different types of patterns. 
We talked about the special patterns BEGIN and 
END, about expressions as patterns, and simple 
regular expressions. 

This time well first talk about some of the more 
complex pattern types and later we'll get into a more 
detailed discussion of regular expressions. 

The first of the more complex patterns I will 
discuss are known as Compound Patterns. These are 
expressions which combine other expressions with 
logical ANDs, ORs, and NOTs. For example, you can 
have: 

$1 =="Mary"&&$3>100 

Again, standard C operators are used, &&, I I 
and ! for and, or and not. In this case, the pattern is 
true for any record where the first field contains 
exactly the string value "Mary" and the third field is 
greater than 100, when considered as a numeric 
variable. This reminds me of something I glossed over 
in part one of this series on AWK. Let me digress for 
a second. While a field which contains a "pure" 
numeric value is considered as a numeric field, it can 
be referenced in the context of a string variable. 
When used so, the value of the variable is converted 
to a string variable before the value of the variable is 
referenced. This is also true with alphanumeric 
variables, in fact. That is, a string variable 
refernenced in a numeric context, it's ASCII values 
are converted to an numeric value. The effect is 
analogous to an atoi() or an atofl) function call in C. 
Let me finish this digression by commenting that it 



should be obvious that variables are referenced more 
efficiently in the context of which the are defined as. 

Oh yes, let me finish describing the previous awk 
programming statement by saying that for all records 
which the complex pattern is true, the entire record 
will be displayed to the standard input. Actually, 
since no action is specified, the default action is 
processed for all records which match the patter. That 
action is: 

{print $0} 

So, the previous example is a shorthand form of the 

following awk programming 

statement: 

$1 = "Mary" && $3 > 100 {print $0} 

Range Patterns are two patterns separated by 
commas. The range pattern is true for all records 
starting with a record for which the first pattern is 
true and then continuing sequentially through the file 
up and including a record, if found, for which the 
second pattern is true. If the first pattern is never 
true, no records will be processed. If the first pattern 
is ever true, and the second pattern is then never 
true, all records starting with the one which matched 
the first pattern through to the end of the input are 
processed by the range pattern's associated action. 
Each of the two patterns may be of any of the 
different types of patterns. For example: 

/Alfred/, /Karen/{print$1,$2} 

This is two regular expressions as the first and 
second pattern. In this case, the first record found which 
contains the substring "Alfred" and all records after it up 
to and including a record, if found, which contains the 
substring "Karen" are processed by the patterns' 
associated action. 

Also, a valid range pattern is: 

NR>3, NR>10 

This shows that the two a parts of a range pattern 
can be expressions as well as regular expressions. 
(Remember the difference between an expression and a 
regular expression?) In this case the 4th through the 
10th record are all processed by the patterns' action. I 
had to think about this one for a second. Remember, 
after the first pattern is true all records are processed 
UNTIL the second pattern is TRUE. 

Here's something similar: 

$3>100, $3<200 

In this case, if a record is found which has its third 
field greater than 100 then that record and all 
subsequent records will be processed by the action, until 
a record is come upon which has the third field less than 
200. That record will be processed, too, but none after it. 
This one deserves a second thought also, but I'll let you 
handle that. Another interesting use for a range pattern 
would be this: 

$1 — "Mary", $NF = 
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In this case, the first record found to have the first 
field equal to the character string "Mary" and all records 
after that will be processed until a record is found 
whose LAST field contains a value of zero. That will be 
also processed, but none after. Note that using the NF 
variable to denote 

the LAST field in a record, a file with variable numbers 
of fields in the records would be no problem. 

A range pattern may not be part of another pattern. 

Last time I talked about simple regular expressions. 
Lets get back into them. The type of pattern which 
contains a regular expression is called a "string 
matching pattern". A pattern can contain more than one 
regular expression. It will contain either a single regular 
expression, or a regular expression used in conjunction 
with an expression. To indicate a regular expression, it 
is surrounded by slashes. This string matching pattern 
must fit one of the following three general formats: 

1) /regexp/ - Matches with the current input l 
ine contains a substring matched by the 
regular expression regexp. 

2) expression ~ /regexp/ - Matches it the string 
value of expression contains a substring 
matched by the regular expression regexp. 

3) expression !~ /regexp/ - Matches if the 
string value of the expression does not 
contain a substring matched by the regular 
expression regexp. 

Any expression may be used in place of /regexp/ 
in the context of ~ and !~. Here's examples of more 
complex string matching patterns: 

$4 ~ /Mary/ 

This is an example of type 2 above. In this case, 
field #4 of the input record must contain the substring 
"Mary" for the pattern to be true. Consider the 
following: 

$1 ~$3 

In this case the /regexp/ is replaced by an 
expression, in this case, the field variable $3. This can 
only be done in the context of - and !~. The ! operator is 
use as a NOT modifier. Here is an example of its use: 

$5 !~ /Phil/ 

This pattern would be true for all records which did 
NOT contain the substring "Phil". But, we have really 
only touched on what came come between the slashes 
for a regular expression. So far, all examples with 
regular expressions contained only a character string. 
There are many special characters called 
"metacharacters'* which can be used to indicate special 
processing. 

For example, the " A " character matches the 
beginning of a string and the "$"character matches the 
end of the string. These metacharacters may appear 
alone or in combination in a pattern. Consider the string 
matching pattern: 



In this case, the regular expression says to match 
with a string which starts with the C, and ends with the 
o, and has an hicag in between. So, only records whose 
first field is the string "Chicago" (not just contains the 
substring) will match and the pattern be true. The "*" 
character matches any size string of any characters, and 
the "?" character matches zero or one occurances of the 
previous character. Example: 

$2~/ A Z*/ 

This pattern would be true for all records in which 
the second field BEGAN with the character "Z" 
(UPPERCASE Z), followed by zero or more of any 
character. Consider this example: 

$4 ~ /ing$/ 

This pattern would be true for all records whose 
fourth field ENDS with the substring "ing". Here's 
another. 

$5 -/A?/ 

This pattern would be true for any record whose 
fifth field contained either the value "A" or "AA". The 
last metacharacter I will discuss is the I] pair. The I] 
contains one or more individually considered characters 
in it. It can also specify a range. For the pattern to be 
true, the string must match only the characters listed 
within the [] f s. For example: 

$1 ~/ A [ABC]/ 

This pattern is true for all records whose first field 
starts witn one of the characters, "A", "B", or "C", and is 
followed by zero or more of any characters. Note that 
the comparison is VERY case sensitive! Here's an 
example of a range: 

$2~/ A [a-zA-Z]/ 

This pattern is true for all records which has a 
second field which has as its first character a letter, 
upper or lower case. It may have zero or more 
characters after the initial letter. Be careful when using 
combinations of metacharacters! Consider the following 
example: 

$2~/ A [a-zA-Z]V 

Now, at first glance, you might think that this does 
the same thing as the previous pattern. Uh, uh, it 
doesn't!! In fact, it will match on field two no matter 
what field two contains! You see, the first metacharacter 
is the dual character range which matches only a single 
character. Let's say that the range does match the first 
character. Then, no matter what is next, the "*" 
metacharacter will match it. But, let's say that the range 
does not match. Then no matter what is next the ,H " 
metacharacter will match it! 

So, this pattern matches anything, which nullifies 
the reason to even attempt the first character 
verification. So, use the "*" metacharacter carefully!! 

Multiple ra^tees may also be specified. For example: 

$2~/A[0-9][A-Z]$/ 



$1 - / A Chicago$/ 
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In this case, only records in which the second 
field starts with a numeric character and ends with 
an upper case alphabetic character. 

This is as deep as I want to get with regular 
expressions. Ill end this time with a quickie awk 
program which may help to illustrate a technique. 

You want to know how many total bytes are 
used by the files in the current directory. Consider 
the command: 

$ dir -e ! gawk *NR > 3 { tot += $6 } END 
{print 'Total bytes", tot }' 

While the actual use of this command is a 
waste of time if you have a copy of the Is 
command which can supply file size totals, it 
illustrates how you can interpet system function 
displays by awk programs. In this case, the first 
three lines are ignored, and all subsequent lines, 
the 6th field, the size in bytes, is summed to the 
variable tot. At the end of file, the total is 
displayed. An equivalent command line would be: 

$ dir -eu ! gawk '{ tot += $6 } END 
{ print "Total bytes", tot }' 

This example also shows an arithmetic 
expression I haven't mentioned, ie, the use of the 
"+=" arithmetic operator. As you might expect, all 
C type arithmetic expressions are supported in 
awk programs, including the auto pre or post 
increment. 

Next time, we'll concentrate more on the action 
part of AWK programming statements. 

Zack Sessions 

sessions@seq.uncwil.edu 

University of North Carolina at Wilmington 

"Good health is merely the slowest form of dying' 1 
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* Strips leading spaces 


• Entrq: 


X - Address of line 


• Exit: 


X - Points 


to first non- space character 


EatS pace 


pshs a 


Eat2 


Ida 


x+ 




cnpa 


»$20 




beq 


Eat2 




leax 


-1.x 




puis 


a 




rts 




* Entrq of program 


Start 


decb 


anq parens? 




beq 


Help nope, extt w/ error 




cm 


Path assume stdin upon entrq 




cm 


IncFlaq, Clear (OFF) ncluston flaq, 




clr 


FileFlao, Clear printing of filenames 




clr 


Anchor Anchor to first colunn 




clr 


FEFtas Clear Fork/Echo flao, 




clr 


ForkFlaa, Clear Fork fla<b 




Ida 


*$20 put space as extra delimiter 




sta 


Delin 


• Connand line parsing is done here 


Parse 


bsr 


EatS pace 




Ida 


x+ 




cnpa 


**0d 




beq 


Help 




cnpa 


#•- 




bne 


IslLQ 


• Dash options parsed here 




Ida 


,x+ load A with char 




cnpa 


*'a is it the anchor option? 




bne 


IsItF 




bsr 


Str2bute 




sib 


Anchor 




bra 


Parse 


IsItF 


cnpa 


••f 




bne 


IsItUpF 




Ida 


nff 




sta 


Forkflaq, 




bra 


Parse 


IsItUpF 


cnpa 


*'F 




bne 


IsItL 




da 


♦Sff 




sta 


FEFtaq, 




bra 


Parse 


ISltL 


cnpa 


#'! 
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bne 

Ida 

sla 

bra 

cnpa 

bne 

Ida 

sla 

bra 

cnpa 

bne 

(da 

sla 
bra 

line 

• Format String 
lslLQ cnpa 
bne 



IslU 



IslU) 



IslU 
*$FF 
FiieFtao> 
Parse 

IsILD 

*Sff 
lncFlaq> 
Parse 
**d 
Help 
x+ 



is it the inclusion option? 
set Inclusion Fia&, 



delimiter? 

bad option - error out 

else load character after 



the 'D' 



Debn save it... 

Parse then o»o back to parsing the 

detected here 

*" Is it a '" fornat string? 

Help nope, nust be an error 



* Save the fornat string 
SaveFnat leaq Fomat,u 
SaveFnt2 Ida 

first '" 

cnpa 

beq 

cnpa 

bne 

Ida 

sta 

bra 
SaveFnt3 sta 

bra 
ChkFHe ibsr 
filenane 

Ida ,x 

cnpa *$0d 
Stdln 

beq MainLme 

bra OpenFile 



* Help Routine 



x+ 



Pomt to char after 



*$0d 

Help 

*" is it the second "*? 

SaveFnt3 no, save char 

*$0d 

ChkRle 

,u+ else save char 

SaveFnt2 

EatSpace Check after last '"' for a 



if no filenane, execute fron 



Help 



leax 
Ida 

OS? 

bra 



HelpMess.pcr 
*2 

UWntLn 
Done 



Show Help nessa^e 



Check for EOF 



EOF 



pointer 



cnpb 

bne 

Ida 

os9 

puis 

tst 
beq 

bra 



*E*EOF 

Error 

path 

ISClose Close path 

x and restore the end line 

Path 
Done 
FilePrs 



Exit Yiere 



Done clrb 

Error os9 F$Exit 



dAWK- o,oes here if files are on the end line 



FilePrs Ibsr EatSpacc eat spaces 

Ida ,x check char 

cnpa *$0d if CR, 

beq Done 



OpenFile 



Ida 
os9 
bes 

sta 
tst 
beq 
Ibsr 



Ibsr 
•read. 

UOpen 

Error 

Path 

FileFlao, 

MamLine 

PmFile 



SaveFile 

else assune a file nane 

and tru, to open it 



* The following lines are the "heart" of bAWIC's processing 



MamLme pshs 



save pointer to end line 



The line of input is read fron here. 



ReadLme Ida Path a>et path 

Idq *250 nax chars per line 

leax Line.u point to line buffer 

osp I*ReadLn and read the line 

bes EOF check EOF if error 



The Process of Expansion starts here. 



PFnt2 



ProcLtne 

leaq 
expansion line 

ParseFnt Ida 
cnpa 
beq 
sta 
cnpa 
bne 
tst 
bne 
bsr 
tst 

set 

beq 

PFnt3 Ibsr 
bra 

FieldPar Ida 
cnpa 
beq 
leax 

FieldP2 Ibsr 
tstb 
bne 



leax FornaUu 

ExpLine.u Position y to 



,x+ 

*'t Is it the T field character? 

FieldPar Check Field Paraneter 

*$0d 

ParseFnt 

ForkFlao, 

PFnt3 

Print 

FEFtao, see if the fork/echo fiaq> is 

ReadLme 

Fork 

ReadLme 

,x+ o>et char after '$' 

*'$ Is it another? 

PFnt2 uep, store it 
-1.x 

Str2bute convert the nunber 

check the nunber to see if it's 
Fieldl 



The entire line is copied at the direction of $0 



entire... 



pshs 
leax 

Ibsr 



Une.u at this point we copq the 
AncLtne Anchor the line 
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CopqAit Ida 

tine 

cnpa 

$0 

beq 

sta 

bra 



,x+ and transfer the rest of the 

**0d line since we've encountered a 



Fields 
CopqAH 



and continue parsing 



Field! 



Field2 
Field3 



pshs 

bsr 

tstb 

beq 

tst 

bne 

puis 

bra 

bsr 

puis 

bra 



x save position m format string 

SetField Position to the proper field 

was there an error? 
Field2 no, continue with expansion 
lncFlaq, is the inclusion flao, set? 
Fietd2 
x 
ReadUne 

Expand 

x <^et position in fornat stnno, 

ParseFnt and continue expanding.. 



• SETFIELD - This routine positions the X pointer to the 
correct field 



• Entru,: d 

• Exit: 
set) 



b • 
X 



Number of the field 

clear if field was found, set if it wasn't found 
Address of bth field (Points to EOLN if b is 



SetFsetd leax 
Ibsr 

Skip Ida 

cnpa 
beq 
cnpa 
beq 
cnpa 
beq 
decb 
beq 

EatFietd Ida 

cnpa 

beq 

cnpa 

beq 

cnpa 

beq 

bra 

Leave clrb 

Leave2 leax 
rts 



Lme.u 

AncLme Richer the line 

,x+ 

*$20 

Skip 

Delin 

Skip 

*$0d 

Leave2 

Leave 

,x+ 

*$20 

Skip 

Delin 

Skip 

**0d 

Leave2 

EatField 

1.x 



• EXPAND - This routine 'expands" the field into the 
expansion buffer 



Expand 


Ida 


.x+ 




cnpa 


*$20 




beq 


ExEXit 




cnpa 


Delin 




beq 


ExExit 




cnpa 


*$0d 




beq 


ExEXit 




sta 


*r 




bra 


Expand 


ExExit 


rts 





The expanded line is printed to StdOut here 



Print leax ExpLine.u 

expanded hne buffer 

kjq *500 nax chars 500 

Ida #| 

os9 UWntLn write to stdout 

Ibcs Error 

rts 



Point X to the 



• The expanded 


line is used as a paranter to a shell 


Fort pshs 


XXI 


Ida 


♦Pr^rn+Objct 


Idb 


*!6 Use 16 pao>es <io of data 


leax 


Shell.pcr Point to none of 


Shell 




tdu, 


*1096 


leau 


ExpLine.u Pant X to the 


expanded line buffer 


os9 


FiFork Fort it/ 


ibcs 


Error 


OS? 


F$Wait 


puis 


x,u 


rts 




enod 




Size equ 


• 


end 
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